SetCRefCon

SetCRefCon Set control's application- defined reference value

#include <Controls.h> Control Manager

void SetCRefCon( theControl, newRefCon );

ControlHandle theControl ; handle of the control to update

long newRefCon ; desired new reference value

SetCRefCon sets a new "reference constant" value for a control.

theControl is a handle leading to a variable-length ControlRecord structure. It

specifies which control to query.

newRefCon is a 4-byte long integer. It can be any value that has meaning for

the application.

Notes: You can use SetCRefCon to store any 4-bytes of control-related

information into the ControlRecord. It stores newRefCon into the

contrlRfCon field of theControl 's ControlRecord structure. It is

functionally equivalent to:

(* theControl )->contrlRfCon = newRefCon ;

The reference constant is set when the control is created (see

NewControl). Use GetCRefCon to query the current value.

Referenced by (3):